/**
 * @(#)TraductorGoogleTranslate.java 31/05/2010
 *
 * Copyright (c) 2007-2012 PsiqueWare S.A. de C.V. All Rights Reserved.
 * This software is the proprietary information PsiqueWare S.A. de C.V.
 * Use is subject to license terms.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *
 * <br/>Usuario : AngelElectrico
 * <br/>Creaci&oacute;n: 31/05/2010 - 06:01:57 PM
 * <br/>
 * <br/>
 * <br/><t5>Cambios :</t5>
 * <br/><b>Fecha | Autor  |  Cambios</b>
 * <ul>
 * <li>31/05/2010 | <a href = "mailto:AngelElectrico@PsiqueWare.com">&Aacute;ngel El&eacute;ctrico</a> | Creaci&oacute;n del Objeto.</li>
 *
 * </ul>
 */

package com.psiqueware.alheli.i18n.traductor.google;

import com.google.api.translate.Language;
import com.google.api.translate.Translate;
import com.psiqueware.alheli.exception.NullArgumentException;
import com.psiqueware.alheli.i18n.EscuchaTraductor;
import com.psiqueware.alheli.i18n.Lenguaje;
import com.psiqueware.alheli.i18n.Traductor;

import java.util.Arrays;
import java.util.List;

/**
 * {@link Traductor} basado en Google Translate.
 * <br/>Paquete Original: com.psiqueware.orquidea.diccionario.traductor
 * <br/>Nombre  Original: TraductorGoogleTranslate
 * <br/>Oprima para ver : <a href="TraductorGoogleTranslate.java.html"><i>C&oacute;digo Fuente</i> </a>
 *
 * @author <a href="mailto:AngelElectrico@PsiqueWare.com">AngelElectrico</a>
 * @version Revision: 1.1 31/05/2010 06:01:57 PM
 * @deprecated as google is only offering this as a paid service.
 */
@Deprecated
public final class TraductorGoogleTranslate implements Traductor
{

    /**
     * {@link EscuchaTraductor} para notificar de los eventos.
     */
    private EscuchaTraductor m_escucha;

    /**
     * Construye una TraductorGoogleTranslate.
     * <p>No requiere argumentos.</p>
     */
    public TraductorGoogleTranslate()
    {
    }

    /**
     * Construye una TraductorGoogleTranslate.
     *
     * @param escucha para los eventos de traducci&oacute;n.
     */
    public TraductorGoogleTranslate(final EscuchaTraductor escucha)
    {
        m_escucha = escucha;
    }

    /**
     * Indica si un {@link com.psiqueware.alheli.i18n.Lenguaje} es soportado por el {@link com.psiqueware.alheli.i18n.Traductor}.
     *
     * @param lenguaje a evaluar.
     *
     * @return <code>true</code> si y solo si el {@link com.psiqueware.alheli.i18n.Traductor} puede traducir texto desde y hacia este {@link com.psiqueware.alheli.i18n.Lenguaje}; <code>false</code> en caso contrario.
     */
    @Override
    public boolean isSoportado(final Lenguaje lenguaje)
    {
        return null != getLenguage(lenguaje);
    }

    /**
     * Devuelve el {@link Lenguaje} de traducci&oacute;n para Google Translate.
     *
     * @return valor del {@link Lenguaje} de traducci&oacute;n para Google Translate.
     */
    public Language getLenguage(final Lenguaje lenguaje)
    {
        Language m_language = null;
        for (final Language language : Language.values())
        {
            if (language.name().equalsIgnoreCase(lenguaje.name()))
            {
                m_language = language;
                break;
            }
        }
        return m_language;
    }

    /**
     * Traduce un texto de un idioma a otro.
     *
     * @param texto         a traducir.
     * @param idiomaOrigen  {@link Lenguaje} del idioma del texto.
     * @param idiomaDestino {@link Lenguaje} del idioma deseado para el texto.
     *
     * @return el texto traducido; <code>null</code> si no se puede realizar la traducci&oacute;n.
     */
    public String traducir(final String texto, final Lenguaje idiomaOrigen, final Lenguaje idiomaDestino)
    {
        if (null == idiomaOrigen)
            throw new NullArgumentException("<error>El argumento 'idiomaOrigen' no puede ser NULL.</error>");
        if (null == idiomaDestino)
            throw new NullArgumentException("<error>El argumento 'idiomaDestino' no puede ser NULL.</error>");
        if (null == texto) throw new NullArgumentException("<error>El argumento 'texto' no puede ser NULL.</error>");

        if (0 == texto.trim().length()) return "";
        if (null != m_escucha) m_escucha.iniciaTraduccion(texto);
        String traducido = null;
        try
        {
            Translate.setHttpReferrer("http:\\" + Math.round(1000000 * Math.random()) + ".PsiqueWare.com");
            traducido = Translate.execute(texto, getLenguage(idiomaOrigen), getLenguage(idiomaDestino));
            return traducido;
        }
        catch (Exception e)
        {
            final String error = "<error><msg>No se pudo realizar la traducci&oacute;n.</msg><parametros></parametros></error>";
            System.err.println(error);
            System.err.println(e);
        }
        finally
        {
            if (null != m_escucha) m_escucha.finalizaTraduccion(traducido);
        }
        return null;

    }

    /**
     * Traduce varios textos de un idioma a otro.
     *
     * @param textos        a traducir.
     * @param idiomaOrigen  {@link com.psiqueware.alheli.i18n.Lenguaje} del idioma del texto.
     * @param idiomaDestino {@link com.psiqueware.alheli.i18n.Lenguaje} del idioma deseado para el texto.
     *
     * @return el texto traducido; <code>null</code> si no se puede realizar la traducci&oacute;n.
     */
    @Override
    public List<String> traducir(final List<String> textos, final Lenguaje idiomaOrigen, final Lenguaje idiomaDestino)
    {
        if (null == idiomaOrigen)
            throw new NullArgumentException("<error>El argumento 'idiomaOrigen' no puede ser NULL.</error>");
        if (null == idiomaDestino)
            throw new NullArgumentException("<error>El argumento 'idiomaDestino' no puede ser NULL.</error>");
        if (null == textos) throw new NullArgumentException("<error>El argumento 'textos' no puede ser NULL.</error>");


        if (null != m_escucha) m_escucha.iniciaTraducciones(textos);
        List<String> traducciones = null;
        try
        {
            Translate.setHttpReferrer("http:\\" + Math.round(1000000 * Math.random()) + ".PsiqueWare.com");
            final String[] arrTextos = textos.toArray(new String[textos.size()]);
            final String[] traducidos = Translate.execute(arrTextos, getLenguage(idiomaOrigen), getLenguage(idiomaDestino));
            traducciones = Arrays.asList(traducidos);
            return traducciones;
        }
        catch (Exception e)
        {
            final String error = "<error><msg>No se pudo realizar la traducci&oacute;n.</msg><parametros></parametros></error>";
            System.err.println(error);
            System.err.println(e);
        }
        finally
        {
            if (null != m_escucha) m_escucha.finalizaTraducciones(traducciones);
        }
        return null;

    }

}

